Introduction
------------

Brain Jam is a Windows solitaire game based on a rules described by
Martin Gardiner in 1968.  It will appeal to players who like challenging
puzzles.

In each of over 1000 different hands, 52 cards are dealt face up.  The player
must move these cards into four build piles by following a simple set
of rules.  There is no luck involved - all hands are winnable.

Fans call it extremely addictive - their loved ones would like to see it
banned. For a selection of player comments, see the last part of this file.

Installation
------------

Brain Jam will run only under Windows 3.x, Windows 95 and compatible
operating systems.

To install Brain Jam, insert the distribution diskette and from the
Program Manager select File, then Run, and then type A:SETUP.  You
will be asked in which directory to install Brain Jam.  We recommend
that you install in the same directory as your previous version.  This
way any existing solutions will be carried forward to the new version.

Once you have activated Brain Jam by double-clicking on its icon, select
the Help menu for full instructions on using and registering Brain Jam.

Brain Jam comes in shareware and commercial/registered versions, called
BRAINJAM.EXE and BRAINREG.EXE respectively.

The version can be identified by clicking on the Help/About menu.  
Generally the shareware version may be redistributed while the commercial
version may not; for further information consult the Legal Matters section
in the online Help.

Ordering and registration information can also be found in the online Help.

Should you wish to contact us, please send email to brainjam@interlog.com
or check our web page at http://www.interlog.com/~brainjam.

or write to:
  Brain Jam Publications
  P.O. Box 62024
  1448 Lawrence Ave. East, #19
  North York, Ontario
  Canada M4A 2W1


Version History
---------------
5.1 - added games 1100-1199
    
3.0 - help file is created if not there
    - added games 1000-1099

2.5 - updated best scores

2.4 - improved installation for registered version
    - the Brain Jam icon flashes when there are no legitimate
	  moves remaining.

2.3 - best known solutions for each hand are shown

2.2 - added bonus games feature

2.1 - fixes a resource leak

2.0 - all hands are winnable

    - the window background is the color determined in the Control Manager

1.9 - card faces are copied from Microsoft Solitaire,
      which must be resident in the WINDOWS directory.
	  If Solitaire is not installed, a procedurally generated 
	  set of cards is used.

    - fixed a nasty bug that would crash some video drivers after
	  winning a game or trying to exit the program.

1.8 - updated list of winnable games in the range 0-49

    - solutions are kept in the file BRAINJAM.SOL instead of
      BRAINJAM.INI.  If you are upgrading from a previous version,
      existing solutions will automatically be transferred from
      BRAINJAM.INI to BRAINJAM.SOL.  It is recommended that you make
      a backup of the BRAINJAM.INI file before doing  this transfer.

      If you have several old BRAINJAM.INI files
      you can merge their contents into BRAINJAM.SOL by following 
      the procedure for each of the files:
       1) rename the file to BRAINJAM.INI
       2) load Brain Jam
	   3) unload Brain Jam
      Note that if this INI file contains solutions for games included in
      previously transferred files, shorter new solutions will replace the
      longer old ones.

1.7 - various bug fixes

1.6 - improved game selection and review, keyboard interface

1.5 - improved "Deal" function

1.4 - corrected problems with illegitimate game numbers

1.3 - first public release


Fan Mail
--------

The following is a compilation of unsolicited comments made
by Brain Jam fans in North America and the United Kingdom.

Brilliant game.  I can feel my brain sweating!
   - RM, Florida

My wife would like Brain Jam thrown into the River Thames
as it is very compulsive playing.
   - PI, London

Any more really tortuous games?
   - ICS, U.K.

I think your Brain Jam game is terrific.
   - AGF, Florida

There really ought to be a law against it ... what an
insidious piece of software - I am surprised it hasn't
brought about the total collapse of Western Civilization!
... super fun and *extremely* addictive.
   - JH, U.K.

My wife has rapidly become an addict of your game.
   - BK, U.K.

... my wife is addicted to the game ...
   - MN, U.K.

My wife complains that she is a Brain Jam widow!
   - P, U.K.

Great game. One of the few that has stayed on the PC
for more than a week.
   - RL, U.K.

I've finally found a game that my father will play, so
I thought I'd better register a copy for him.
   - AM, U.K.

Thanks for a wonderfully addictive game.
   - CGP, Switzerland

I can't tell you how much I have enjoyed playing your game.
   - JB, Maryland

My wife is still crazy about it..
   - RH

The whole family is addicted to Brain Jam.
   - JP, London

An excellent game!
   - TPH, U.K.

I am almost sorry that I discovered it because I am a law
student and it seems to interfere with my studies!
   - BT, California

I have to admit a serious degree of addiction ... You
certainly have a winner with Brain Jam!
   - BB, U.K.

I think your game is by far the best card game going.
   - TB, FL

A very good solitaire game.  My compliments to the chef.
   - PL, Ontario

Thanks for Brain Jam - it's addictive and much more
challenging than FreeCell !!
   - AM, Ontario
